<?xml version="1.0" encoding="UTF-8"?>
<html filename="docs/SAX/TStreamInputSource.html">
<body>
<a id="#top"/>
<h1>
	                Class Summary : TStreamInputSource </h1> A single stream input source for an XML entity.

 <blockquote>
 <em>This module, both source code and documentation, is in the
 Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
 </blockquote>

 <p>This class allows a SAX application to encapsulate information
 about an input source in a single object, which may include
 a public identifier, a system identifier, and/or a byte stream (possibly
 with a specified encoding).</p>

 <p>An InputSource object belongs to the application: the SAX parser
 shall never modify it in any way (it may modify a copy if
 necessary). However, standard processing of both byte and
 character streams is to close them as part of end-of-parse cleanup,
 which means that the stream will be freed.
 Applications should not attempt to re-use such streams after they
 have been handed to a parser. If StreamOwnership is soOwned then
 TStreamInputSource frees any streams it has been passed when
 necassary.</p>

<br/><b>Since : </b> SAX 1.0
<br/><b>See : </b> <a href="../SAX/IXMLReader.html#parse.IInputSource">IXMLReader.parse(IInputSource)</a>
<br/><b>See : </b> <a href="../SAX/IEntityResolver.html#resolveEntity">IEntityResolver.resolveEntity</a>
<h2>
	              Methods
	            </h2>
<div style="padding-left:10px">
<a href="#setByteStream">
	                  procedure
	                 setByteStream(TStream)</a>
<br/>
<a href="#getByteStream">
	                  function
	                 getByteStream() : TStream</a>
<br/>
</div>
<br/>
<hr width="100%"/>
<a name="#setByteStream">
<p>
<b>procedure</b> setByteStream( byteStream : TStream); </p>
</a> Set the byte stream for this input source.

 <p>The SAX parser will use a byte stream in preference
 to opening a URI connection itself.</p>

 <p>If the application knows the character encoding of the
 byte stream, it should set it with the setEncoding method.</p>

 <p>If the freeByteStream property is true, the StreamInputSource will
 free any stream it currently contains</p>

<br/><b>Parameter : </b> byteStream A byte stream containing an XML document or
        other entity.
<br/><b>See : </b> <a href="../SAX/TStreamInputSource.html#setEncoding">TStreamInputSource.setEncoding</a>
<br/><b>See : </b> <a href="../SAX/TStreamInputSource.html#getByteStream">TStreamInputSource.getByteStream</a>
<br/><b>See : </b> <a href="../SAX/TStreamInputSource.html#getEncoding">TStreamInputSource.getEncoding</a>
<br/>
<p>
<a href="#top">Top</a>
</p>
<hr width="100%"/>
<a name="#getByteStream">
<p>
<b>function</b> getByteStream() : TStream; </p>
</a> Get the byte stream for this input source.

 <p>The getEncoding method will return the character
 encoding for this byte stream, or nil if unknown.</p>

<br/><b>Result : </b> The byte stream, or nil if none was supplied.
<br/><b>See : </b> <a href="../SAX/TStreamInputSource.html#getEncoding">TStreamInputSource.getEncoding</a>
<br/><b>See : </b> <a href="../SAX/TStreamInputSource.html#setByteStream">TStreamInputSource.setByteStream</a>
<br/>
<p>
<a href="#top">Top</a>
</p>
</body>
</html>